home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr05 / count_27.zip / COUNT!.TXT < prev    next >
Text File  |  1993-07-10  |  18KB  |  437 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                 COUNT! v2.7
  23.                                  April 1993
  24.  
  25.  
  26.                        Network Administrators Guide
  27.  
  28.  
  29.  
  30.     This document is intended for Network Administrators and assumes the 
  31.     audience is familiar with MS Windows v3.0 or above, MS DOS v3.3 or 
  32.     above, and basic network management principals.
  33.  
  34.  
  35.  
  36.  
  37.                              Table Of Contents
  38.  
  39.  
  40.                     Topic                             Page
  41.                     ---------------------             -----
  42.                     What is COUNT!                      1
  43.                     Using COUNT!                        2
  44.                     Setting up COUNT! on a network      5
  45.                     Methods of controlling access       5
  46.                     USER Messages                       6
  47.                     Registering COUNT!                  7
  48.                     Transferring a License to COUNT!    7
  49.  
  50.  
  51.                                 COUNT! v2.7
  52.                        Network Administrators Guide
  53.                                   Page 1
  54.  
  55.  
  56.                               What is COUNT!
  57.  
  58. COUNT! is a MS Windows utility that enables you to abide to "simultaneous 
  59. use" licenses in a network environment.  This type of license allows you 
  60. to provide applications to a user community without buying a license for 
  61. each potential user.  The result is typically an 80% to 90% reduction in 
  62. the cost of the application.
  63.  
  64. Simultaneous use licenses:
  65.     Unlike mainframe programs which base the fee on the number of 
  66.     potential users of a product, personal computer software licenses are 
  67.     often based on the number of people using a program at any point in 
  68.     time.  If the network provides a dozen applications to 50 users, it is 
  69.     probable that five to ten licenses for each application will be 
  70.     sufficient to meet the needs of the 50 users without purchasing 50 
  71.     licenses of each.
  72.  
  73.     Most major suppliers of personal computer software base their license 
  74.     on simultaneous use.  However, many of these (Microsoft for example) 
  75.     provide no means for maintaining the license.  Should you wind up in 
  76.     court, you are required to provide evidence that adequate precautions 
  77.     were taken to ensure that the simultaneous use license was not violated.
  78.  
  79. What does COUNT! Do:
  80.     COUNT! launches programs in an MS windows environment and keeps track 
  81.     of the number of users.  It will enable you to enforce simultaneous 
  82.     use licenses.  It also provides features to make many programs which 
  83.     function poorly in a network environment behave better.
  84.  
  85.     COUNT! enables a user to access an application as easily as if it were 
  86.     installed on his local hard disk.  To to this, it will if necessary:
  87.  
  88.          Establish a network connection
  89.          Modify the current DOS directory
  90.          Check for license availability
  91.          Execute the program
  92.          Free the network license
  93.          Disconnect the network connection
  94.  
  95. What COUNT! Won't Do:
  96.     It is possible for a Windows application to be written so the main 
  97.     (loading) executable file (.EXE) terminates before the application 
  98.     does.  COUNT! cannot meter the licensing of such programs since it has 
  99.     no way of knowing when the program ends.  I am not aware of any major 
  100.     commercial application software that exhibits this behavior.
  101.  
  102.  
  103.                                 COUNT! v2.7
  104.                        Network Administrators Guide
  105.                                   Page 2
  106.  
  107.  
  108.                                Using COUNT!
  109.  
  110. An end user needs no special knowledge to use COUNT!  He simply launches 
  111. applications normally through Windows.  A license dialog box appears 
  112. informing him the license is being shared.  If no more licenses are 
  113. available, the dialog box will inform him of that and provide a list of 
  114. current users.
  115.  
  116. To set-up applications to run under COUNT!, a network administrator should 
  117. be familiar with the Windows Program Manager, and the methods to launch 
  118. applications.  There are several ways to launch a windows application.  
  119. The most typical is for the user to "double click" on an application icon 
  120. in a Program Manager group.  The second is to use the file manager to 
  121. launch an application with a selected data file.  A third is to launch the 
  122. application using the Program Manager's "Run command".  You do not need to 
  123. support all methods as a network administration manager.  All are covered 
  124. here.
  125.  
  126. COUNT! is a Windows application which launches other applications.  The 
  127. "launched" application is a parameter for COUNT!.  For instance, to launch 
  128. Microsoft's Excel, the program line could be "COUNT! MS_Excel".  To launch 
  129. Aldus' Persuasion, the program line could be "COUNT! Persuasion".  COUNT!  
  130. would then do everything necessary to make appropriate network 
  131. connections, start the application, and enforce software licenses.
  132.  
  133. This raises two questions.  How do you use the COUNT! command line under 
  134. Windows, and how does COUNT! know how to make network connections, etc., 
  135. for each application.
  136.  
  137. Using the COUNT! Command Line:
  138.     All the methods of launching an application with COUNT! require the 
  139.     use of a COUNT! command line.  The command line has the form 
  140.     "COUNT! ApplicationName".  COUNT! launches the program associated with 
  141.     ApplicationName.
  142.  
  143. Supporting Applications Launched via a Program Manager Application Icon:
  144.     You will need to modify the vendor supplied installation procedure to 
  145.     modify the icon's "properties" to use COUNT! to launch the program.
  146.  
  147.     The application icon program line properties can be changed using the 
  148.     following procedure:
  149.  
  150.          In Program Manager, select the program icon by clicking on it 
  151.          once with the mouse.
  152.  
  153.          Select File-Properties, from the Program Manager's menu.  A 
  154.          "Program Item Properties" dialog box should appear.
  155.  
  156.          Change the command line in the dialog box to launch the program 
  157.          through COUNT!  ie.  "COUNT!.EXE MS_Excel".
  158.  
  159.  
  160.                                 COUNT! v2.7
  161.                        Network Administrators Guide
  162.                                   Page 3
  163.  
  164.  
  165.          You should also change the icon to the application's normal icon, 
  166.          which is typically in the main .EXE file of the application.  
  167.          This is also done from the "Program Item Properties" dialog box.
  168.          Press the "Change Icon" button and type in the file name 
  169.          containing the Icon (ie. E:\EXCEL\EXCEL.EXE)
  170.          
  171.          The Program .exe file may not be available to Windows if the 
  172.          network drive is not currently connected.  In this case you can 
  173.          substitute an icon from PROGMAN.EXE or MORICONS.DLL.  You could 
  174.          also use a 3rd party utility to extract an icon from an 
  175.          application .exe file, and make the icon file available to Windows.
  176.  
  177. Supporting Applications Launched via File Manager:
  178.     You need to modify the "[extensions]" section of WIN.INI to associate 
  179.     COUNT! with the extension of data files your program runs.  Again, you 
  180.     must supply a command line such as "XLT=COUNT!.EXE MS_Excel ^.XLT".  
  181.     Modifing user .INI files can be automated by using the Fix_INI! 
  182.     program which accompanies Count!
  183.  
  184. Supporting Applications Launched via Program Manager's Run Command:
  185.     The user would have to enter a correct COUNT! command Line in Program 
  186.     Manager's "RUN" dialog box.
  187.  
  188.  
  189. How COUNT! Launches the Application:
  190.     The COUNT!.INI file controls what COUNT! does in launching an 
  191.     application.  COUNT!.INI consists of a number of applications 
  192.     "Sections" containing keywords describing how to launch the 
  193.     application.  Each section begins with the ApplicationName in square 
  194.     brackets.  Keywords can be any of the following:
  195.  
  196.          ConnectDrive=Drive:,Network_Path,Password
  197.              (Only Windows 3.1 and Above support this command.  You can 
  198.              use "Connect" to support Windows 3.0)  The Password can be 
  199.              optional.  However, the comma separator must be included.  
  200.              You can use "*" as the Password and the User will be prompted 
  201.              to provide one.  If The Drive and Network service are already 
  202.              in use, this command is ignored.  Network Drives which are 
  203.              connected with this command are Disconnected when the the 
  204.              user exits the application.
  205.          Connect=Network connection command (you would issue at a DOS prompt.)
  206.          Disconnect=Network disconnection command
  207.          StartDirectory=Starting directory
  208.          Execute=Program invocation command
  209.          CountFile=R/W file which holds the current users/license counts
  210.          MaxUsers=Number of users that can use the program simultaneously
  211.          MaxTime=Number of minutes of program use before Count! reminds the 
  212.              user to free the application license when done.
  213.          UpdateLicense=Number of minutes between updates of the
  214.              CountFile.  The default is 5.  A 0 inhibits updates.
  215.  
  216.          All keywords other than Execute are optional.
  217.  
  218.  
  219.                                 COUNT! v2.7
  220.                        Network Administrators Guide
  221.                                   Page 4
  222.  
  223.     If a CountFile is used, A DOS environment variable must exist prior to 
  224.     entering Windows which provides a user name.  This is accomplished by 
  225.     the DOS SET command as follows:
  226.          "SET Name=UserName"
  227.  
  228.     The UserName must be unique to each network node.
  229.  
  230.     The COUNT!.INI file can be created with any file editor such as 
  231.     NotePad.  Below is an example COUNT!.INI file
  232.  
  233.          [MS Excel]
  234.          Connect=USE E:\\MyServer\ExcelProgram /R
  235.          Execute=E:\EXCEL\Excel.EXE
  236.          Disconnect=USE E: /D
  237.  
  238.          [MS Project]
  239.          ConnectDrive=L:,\\MyServer\MSProject,,
  240.          Execute=L:\WinProj\Project.EXE
  241.          StartDirectory=c:\Project
  242.          CountFile=Q:\Licenses\Licenses.Dat
  243.          MaxUsers=10
  244.          MaxTime=120
  245.  
  246.  
  247.                                 COUNT! v2.7
  248.                        Network Administrators Guide
  249.                                   Page 5
  250.  
  251.  
  252.                       Setting Up COUNT! on a Network
  253.  
  254. COUNT!.EXE and COUNT!.INI need to be placed in a common network directory 
  255. accessible to all users.  Users should be granted READ ONLY access to 
  256. these files.
  257.  
  258. If a CountFile is used to monitor or meter access (via MaxUsers), a common 
  259. user READ\WRITE area needs to be made available for this file. COUNT! will 
  260. create the CountFile as required.
  261.  
  262. Also, as mentioned previously, A DOS environment variable must exist 
  263. (NAME=UserName) if a CountFile is used.  It is suggested that this be 
  264. created in each nodes AutoExec.Bat or Network Connection.Bat file.
  265.  
  266.  
  267.                        Methods of Controlling Access
  268.  
  269. There are two ways to use COUNT! to enforce simultaneous use licenses.  
  270. One method is to put each application you want to control access to in a 
  271. unique network service, and place a limit on the number of connections to 
  272. this service.  COUNT! could then connect to the service before starting 
  273. the program, and disconnect when done. The server would preform the 
  274. license counting/metering.
  275.  
  276. The above method is the most secure method of controlling access. However, 
  277. there may be situations in which you cannot or prefer not to create unique 
  278. network services for each application.  You can then use COUNT!'s MaxUsers 
  279. keyword to control access.
  280.  
  281. When a program is launched, COUNT! first checks the CountFile (if 
  282. specified) to see if the number of current users is less that the MaxUsers 
  283. defined in COUNT!.INI for that application.  If so, COUNT! adds an Entry 
  284. to the CountFile similar to the one below:
  285.  
  286.          [MS Project]
  287.          John Doe=09:33:27 02/12/92
  288.  
  289. The timestamp is updated every 5 minutes unless overridden with the 
  290. UpdateLicense Keyword.  The Entry is removed when the user exits the 
  291. application.
  292.  
  293.  
  294.                                 COUNT! v2.7
  295.                        Network Administrators Guide
  296.                                   Page 6
  297.  
  298.                               USER Messages
  299.  
  300.      There are a few messages COUNT! passes on to the user that a Network 
  301.      Administrator needs to be aware of.  These are covered below:
  302.      
  303.        "All Licenses for this application are currently in use!"  A user 
  304.         will get this message when all licenses set by the MaxUsers 
  305.         parameter are in use.  They will also get a list box identifing 
  306.         users so they can try to free up a license on their own.
  307.      
  308.        "Please Exit AppName IMMEDIATELY!  License VIOLATION!"  Through an 
  309.         Application error or user tampering, the license reserved for this 
  310.         user in the CountFile has been erased.  A user should Never get 
  311.         this message.  It sould be looked into by the Network 
  312.         Administrator.
  313.  
  314.        "You have exceeded the recommended time limit for this application
  315.         and are reminded to free this license when you are finished so 
  316.         that others may use the program."  A user will get this message if 
  317.         he uses the program beyond the MaxTime variable.
  318.  
  319.       The remaining messages should not normally be seen by a user, but 
  320.       may arrise in setting up applications to run under COUNT!
  321.  
  322.        "Could Not Connect (to Drive)"  A network Error caused by an 
  323.         incorrect DOS drive or Network file service specification in 
  324.         COUNT!.ini, or unidentifable network connection problem.
  325.  
  326.        "Drive In Use on Different Service"  A failure to connect to the 
  327.         requested network service in COUNT!.ini because the requested Drive 
  328.         is already being used for a different network service.  You should 
  329.         not set up two network file services to share the same DOS Drive.
  330.  
  331.        "Could Not Execute"  Execution of the application failed.  Most 
  332.         often this is caused by an error in COUNT!.ini or perhaps a DOS 
  333.         PATH Error.
  334.  
  335.        "Could Not Find Count!.ini"  COUNT!.ini is not in the same 
  336.         subdirectory as COUNT!.exe.
  337.  
  338.        "No Application Specified"  No ApplicationName was specified on the 
  339.         COUNT! Command Line.
  340.  
  341.        "No Program to Execute in Count!.Ini"  No "Execute=" was included.
  342.  
  343.        "Name Environment Variable Not Defined!"  You MUST have a Name 
  344.        Environment Variable defined if you are using a CountFile.
  345.  
  346.  
  347.                                 COUNT! v2.7
  348.                        Network Administrators Guide
  349.                                   Page 7
  350.  
  351.  
  352.                             Registering COUNT!
  353.  
  354. COUNT! is copyrighted software and all rights are reserved by the author.  
  355. You are free to evaluate the product for 30 days to determine its 
  356. suitability to your needs.  Use beyond 30 days requires registration.
  357.  
  358. Anyone with the conscience to use COUNT! will want to register it.  A 
  359. license to COUNT! enables you copy and use the software on a single server 
  360. for up to 100 Users.  The cost of the license is $59.  If you would like 
  361. to register, please fill out the form on the next page.
  362.  
  363. In return, you will be sent a diskette with a registered version of the 
  364. software.
  365.  
  366.                       Transferring a License to COUNT!
  367.  
  368. Upon registering, you will receive a license number.  To license the 
  369. software, you will need Read/Write access to the directory where 
  370. COUNT!.EXE is located.  From Windows Program Manager, use "File Run" and 
  371. place in the command Line "Drive:\Path\COUNT!.EXE /L".
  372.  
  373. You will prompted you for your company and server name.  You are limited to 
  374. approximately 25 characters, so you may have to abbreviate.  If the Name 
  375. appears truncated in the Main dialog box, you can reinstall the license.
  376.  
  377.  
  378.                             COUNT! v2.7 User Registration
  379.  
  380.      NAME:             ____________________________________
  381.  
  382.      Company:          ____________________________________
  383.  
  384.      Street:           ____________________________________
  385.  
  386.      Town, State, Zip: ____________________________________
  387.  
  388.  
  389.      Please register me for (____) copies of COUNT!.  Enclosed is $59.00 for
  390.      each copy (plus 6% Sales tax for Maine residents).
  391.  
  392.      Preferred Media:  5.25"(360K) ____  3.5" (720K) ____
  393.  
  394.      Please make checks payable to:
  395.                        Edward Derzawiec
  396.                        6 Sweet Fern Road
  397.                        Cape Elizabeth, ME  04107
  398.  
  399.      Signature:   ____________________________________
  400.  
  401.      In signing this form I agree:
  402.           1. Not to make copies of the registered software received for
  403.              purposes outside of my use on a single network server.
  404.  
  405.           2. Not to modify the software without written consent of the author.
  406.  
  407.      I welcome your comments on the merits or limitations of COUNT!, or
  408.      enhancements you would like to see added.
  409.  
  410.          _______________________________________________________________
  411.  
  412.          _______________________________________________________________
  413.  
  414.  
  415.      To improve the testing of COUNT!, please answer the following:
  416.  
  417.          Server Type:
  418.               Operating System: DOS ____, OS2 ____, VMS ____, UNIX ____
  419.                                Other _________________
  420.  
  421.               Network OS:  Novel ____, Vines ____, PCSA ____, Other ________
  422.  
  423.          Nodes:
  424.               PC/XT (8086/8088) ____,   AT (286) ____,  (386/486/SX CPU) ____
  425.               Display: Mono, ____, CGA, ____ EGA, ____ VGA, ____  Color ____
  426.               Windows Version ____
  427.  
  428.          Applications Count! is Used For:
  429.               
  430.                ______________________________________________________________
  431.  
  432.      ========================================================================
  433.      Do not write below this line:
  434.  
  435.          Serial number licensed to above user: ____________
  436.  
  437.